home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / pcboard / ofile18a.zip / OFILE.DOC < prev    next >
Text File  |  1996-11-06  |  13KB  |  251 lines
  1.              OFILE.PPE  -  Copyright Slob-Trot Software Oy Ab  
  2.  
  3.  
  4.                On-Line File manager for PCBoard BBS 15.22 -->
  5.  
  6. This PPE eliminates the dangers of having to let your Fileoperator into your
  7. DOS (you don't need PCBFILER anymore either), and the danger of your board
  8. hanging while beeing out in the DOS! You can also forget about DOORWAY, since
  9. O-File does not need it.
  10.  
  11. -  What can you do with O-file?
  12.  
  13. O-file does the same thing as PCBFILER.EXE. You can Move, Delete and Copy
  14. files from/to any conference and DIR you want while on-line in the BBS! Easy
  15. Flagging/Unflagging, extended keyboard commands (PGUP[S]/PGDOWN[X]/KeyUP[A]/
  16. KeyDOWN[Z]../Description editing.. and so on), and a logfile with information
  17. of who has used the application, so that the SysOp can keep track of when the
  18. File operator has taken care of file handling.
  19.  
  20. - Installing
  21.  
  22.   To install Ofile, you must add O-file to your CMD.LST file.
  23.   This can be done with the INSTALL.EXE that is included with O-File.
  24.  
  25.   The Install Utility Installs O-File to be used by anyone who's security
  26.   level is 10 or higher. If this is not OK, you will have to modify the level
  27.   yourself. The command for running O-File after installing is "OFI".
  28.  
  29.   Make sure the DISP\ SubDirectory has the SELDISP file in it.
  30.  
  31. - Usage
  32.  
  33. When you run it from your board, your conferences will be displayed with a
  34. lightbar on the main board.. Move the lightbar to the desired conference and
  35. press return (or arrow-right) (or forget the lightbar and simply type the
  36. number of the conference, If you have less then 10 conferences you will not
  37. have to press return after the conference number.).
  38.  
  39.         Functions in Conference list: (V)iew hard-drives
  40.                                       (H)elp screen
  41.  
  42. Selecting filearea (DIR.LST), Now you should select a directory in the
  43. selected conference. And if you are in the wrong conference you can go back
  44. to the list of conferences with the ESC-key or arrow-left
  45.  
  46.         Functions in Filearea list:   (V)iew hard-drives
  47.                                       (H)elp screen
  48.  
  49. You are now in a filelist, with the first line of each file
  50. description representing the file. You can use the following keys for moving
  51. the lightbar: UP, A, DOWN, Z, PGUP, S, PGDOWN, X, HOME, END
  52.  
  53. Functions in Filelist (DIR.LST) list:
  54.  
  55. SPACE / RETURN = Flag a file for beeing processed. When you flag the file the
  56.                  Fileline will get lightblue, and the lightbar is moved to
  57.                  the next fileline. The filename you flagged will appear in
  58.                  the upper right corner of the screen, and the "Amount of
  59.                  flagged files" counter in the lower right corner is
  60.                  increased to the current amount of flagged files. (the second
  61.                  value is the amount of total files in the dirlist.)
  62.  
  63. H - (Help)     = Shows a helpscreen with quick help information about the 
  64.                  functions available.
  65.  
  66. V - (View)     = View the full File description for the file the lightbar
  67.                  stands on. When pressed the filelines will be overwritten
  68.                  with the Description for the file. You can press any key
  69.                  to go back to the filelist.
  70.  
  71. E - (Edit)     = Edit the file description for the file the lightbar stands
  72.                  on. After edited you can select between saving or restoring
  73.                  old description. Description is not saved into physical file.
  74.  
  75. T - (Type)     = Executes the Batchfile you have specified in PCBSETUP for
  76.                  Viewing files in your BBS (usually PCBVIEW.BAT). This way
  77.                  you can view the contents of the files you have.
  78.  
  79. F - (Filter)   = Filter out only those descriptions matching a search
  80.                  criteria. After using this function only the descriptions
  81.                  that matched the search criteria will be listed. The criteria
  82.                  is not case sensitive. The function is similar to the "Z"
  83.                  function in PCBFILER.EXE.
  84.  
  85. R - (Read)     = After using the filter function you might want to read all
  86.                  files into the list again, without having to lose the flagged
  87.                  files. By pressing "R" and selecting (YES) at the question
  88.                  all files will be read into the list again.
  89.  
  90. C - (Copy)     = Will ask if you are sure that you want to copy the files, and
  91.                  if you select yes, you will be prompted for the destination
  92.                  conference, and after that for the destination directory.
  93.                  when you have selected the destination directory the files
  94.                  and descriptions will be copied into the destination
  95.                  directoty. (You will then have duplicate files on your
  96.                  system, unless you delete the original later!)
  97.  
  98. M - (Move)     = Will ask if you are sure that you want to move the files to
  99.                  another directory, and if you select yes you will be
  100.                  prompted for a destination conference, and for a destination
  101.                  directory in the conference. When you have selected the
  102.                  destination the files & descriptions will be moved to the
  103.                  destination.
  104.  
  105. D - (Delete)   = DELETES the flagged files, Use with caution !!!
  106.                  When pressed you will be asked if you want to delete the
  107.                  flagged files, and if you select yes you will be prompted
  108.                  again (ARE YOU SURE blablabla.. ) and if you select yes the
  109.                  second time the files & descriptions will be deleted from
  110.                  your hard-drive and the DIR file.
  111.  
  112. N - (Nuke)     = A nice concept developed by someone else & Now included in
  113.                  O-File. Nuking gives you some options to select from:
  114.                  1) Leave a zerobyte file on hd or not
  115.                  2) Delete description from list or add a NUKED ansi to desc.
  116.                  3) Send uploader a message that he has been nuked (yes/no)
  117.                     The message is located in: DISP\NUKE.MES
  118.                  4) Remove the uploaders credits. If You select yes, then
  119.                     the follwing question will be asked:
  120.                  5) The multiplier to be used when nuking (If you enter
  121.                     "1" then the original filesize will be used if you enter
  122.                     "2" then the nukeamount is 2*FileSize etc..
  123.                     "3" then the nukeamount is 3*FileSize etc..
  124.  
  125.                  The Nukeamount will be included in the ansi added to the
  126.                  description. (at the position of the @NUKESIZE@ code in
  127.                  NUKEANSI.PCB).
  128.  
  129.                  Nuke searches the DOWNLOAD.TXT specified in PCBOARD.DAT for
  130.                  the user that uploaded the file. DOWNLOAD.TXT is searched
  131.                  backwards, thus hopefully finding the uploader faster and
  132.                  finding the last one that uploaded the file (if a file has
  133.                  been uploaded before & deleted etc..). This feature was
  134.                  added on request.
  135.  
  136. ESC - (Ready)  = If no files are flagged when pressing ESC(APE) you will be
  137.                  returned to the list of directories. If you have flagged
  138.                  files a screen with options is displayed, and the options
  139.                  are basically the same as the functions mentioned above.
  140.                  (COPY, MOVE, DELETE, BACK, View flagged files and Quit),
  141.                  selecting any of the options does what the option stands
  142.                  for. You can ususally in O-File return to a previous level
  143.                  with the ESC-Key (exept in the Screen of options where you
  144.                  press (B)ack for the filelist.).
  145.  
  146.  
  147. - The configuration file (OFILE.CFG)
  148.  
  149. There are several options in the configuration file (line1 - line9):
  150.  
  151. You can edit theese manually or with the OCONFIG.EXE that is supplied with
  152. O-File. We recommend using OCONFIG since it is especially made for this task.
  153.  
  154. LINE #1 : Strip chars under 31 when displaying dirlists and Descriptions.
  155.           Can be YES or NO. The stripping of the descriptions will be a
  156.           little bit slower if set to YES.
  157.  
  158. LINE #2 : Write note in LOGFILE.LOG for every time files are processed.
  159.           Can be YES or NO. If set to NO nothing will be written into the
  160.           logfile when processing files.
  161.  
  162. LINE #3 : Check for users conference flags. If this is set to YES the user of
  163.           O-File can only access conferences where he has the "R"egistered
  164.           flag set. You can prevent the fileoperator from knowing about
  165.           possible private conferences this way.
  166.  
  167. LINE #4 : Display only conferences with fileareas in Conf list (YES/NO).
  168.           If this is set to "YES" only those conferences with other fileareas
  169.           then the Upload directories will be included (providing that the
  170.           other settings allows the conference to be included).
  171.  
  172. LINE #5 : Display conference allthough PRIVATE UL dir is the only dir in the
  173.           conference. If this is set to "YES" conferences with a Private
  174.           upload directory will be included in the list of conference
  175.           (providing that the other settings allows the conference to be
  176.           included).
  177.  
  178. LINE #6 : Display conference allthough PUBLIC UL dir is the only dir in the
  179.           conference. If this is set to "YES" conferences with a Public
  180.           upload directory will be included in the list of conference
  181.           (providing that the other settings allows the conference to be
  182.           included).
  183.  
  184. LINE #7 : Write notification in CALLERX (caller log file) each time that
  185.           O-File is started and ended. "YES" =  Write notification
  186.           "NO" = Do not write notification.
  187.  
  188. LINE #8 : Conference in which to place NUKE messages to users.
  189.  
  190. LINE #9 : Strip Colorcodes from file descriptions when editing or viewing
  191.           them. WARNING: The Diz editor goes crazy when you edit descriptions
  192.           with @Codes or colorcodes in them. The saved version of the diz
  193.           should anyhow be correct. This feature was added on request.
  194.  
  195. - The DISP directory
  196.  
  197. There should be a file called SELSCRN in the DISP Directory. That is the
  198. screen with options if pressing ESC at the filelist with files flagged.
  199. There is also a file called NUKE.MES, and that is the message that is sent
  200. to a user when you select to send a message when nuking.
  201.  
  202.  
  203. - Other
  204.  
  205. There are four DOS Executables in the Ofile directory. These are used by
  206. O-File. OFILE.EXE processed the flagged files, and DISKINFO.EXE reads your
  207. hardrives and returns the information to Ofile in the DISKINFO.CAP file. we
  208. are using EXE's for doing these tasks, because of certain restrictions in the
  209. PPL language (and because EXE's are alot faster then PPE's). OCONFIG.EXE is
  210. for configuring O-File without the hassle of editing the .CFG file yourself.
  211. INSTALL.EXE is a simple application that adds the ofi command to your cmd.lst.
  212.  
  213. One known problem with O-file is that When O-File shells out to dos (to run
  214. ofile.exe) you will loose free memory. This is not a flaw in O-File, it is a
  215. problem with PCBoard's internal shelling routines (15.22). In 15.3 there
  216. seems to be less memory loss when shelling to dos.
  217.  
  218. Future enhancements might be: Description cloning, re-reading dir.lst by
  219.                               getting the dizzes out of files. flagging &
  220.                               downloading.
  221.  
  222. - Claims & Licence
  223.  
  224. Slob-Trot Software Oy Ab is the owner of this application, and gives you
  225. the user the right to evaluate the application for 30 Days. If you would like
  226. to use it further you must register the application with Slob-Trot Software.
  227.  
  228. OFILE.PPE and all files belonging to the application is Copyrighted Software.
  229. No Distriution or Copying is allowed without the written permission of Slob-
  230. Trot Software Oy Ab. This evaluation copy may be used for evaluating purposes
  231. for 30 days. Modifying of the code or debugging the software is NOT allowed.
  232.  
  233. Slob-Trot Software is NOT responsible for any damage, harm, economical loss
  234. or anything else that may occur because of OFILE.PPE. You use the software
  235. at your own risk.
  236.  
  237. Slob-Trot Software Oy Ab reserves the right to change this licence without
  238. notice.
  239.  
  240. -----------------------------------------------------------------------------
  241. Bugreports & Comments & Questions are welcome at : "slobtrot@kaapeli.fi"
  242.  
  243. Slob-Trot Software Oy Ab
  244. Uudenkaupungintie 5 B
  245. 00350 HELSINKI
  246. FINLAND
  247.  
  248. PHONE: +358-9-556520 (Business hours 09:00-17:00 Local time(GMT+2))
  249. FAX: +358-9-556030
  250. BBS: +358-9-3404525  (8,N,1)
  251.